home *** CD-ROM | disk | FTP | other *** search
/ Meeting Pearls 4 / Meeting Pearls Vol. IV (1996)(GTI - Schatztruhe)[!].iso / Pearls / libs / bgui / AsmSup / ReadMe < prev    next >
Text File  |  1995-01-30  |  3KB  |  103 lines
  1.  
  2.  The  assmebly  support macros for the bgui.library  operate  simular to  the C
  3. versions of the macros. There are a couple of exceptions though:
  4.  
  5.  o The macro require V38.3 of the library!   This is due to  the usage  of the
  6.    GROUP_Inverted  and  PAGE_Inverted  tags.   The  stuff  will  work on lower
  7.    versions only the GUI is inverted (I.E.  The last object will be first and
  8.    the first object last).
  9.  
  10.  o The layout macros:
  11.  
  12.         FixMinWidth
  13.         FixMinHeight
  14.         Weight
  15.         FixWidth
  16.         FixHeight
  17.         Align
  18.         FixMinSize
  19.         FixSize
  20.         NoAlign
  21.  
  22.    In  the  C  and  E  macro  support  these can be specified directly after a
  23.    EndObject macro. In the assembly macros these can only  be  specified after
  24.    the EndMember macro. This must be done on the same line e.g.:
  25.  
  26.    C version:
  27.  
  28.         StartMember,
  29.                 Button( "Hello", 0 ), FixMinHeight,
  30.         EndMember
  31.  
  32.    Asm version:
  33.  
  34.         StartMember
  35.                 Button hello,0
  36.         Endmember FixMinHeight
  37.  
  38.         hello: dc.b 'Hello',0
  39.  
  40.    Also when you specify more than one layout macro you must seperate them  by
  41.    a comma:
  42.  
  43.    C version:
  44.  
  45.         StartMember,
  46.                 Button( "Hello", 0 ), FixMinHeight, Weight( 100 ),
  47.         EndMember
  48.  
  49.    Asm version:
  50.  
  51.         Startmember
  52.                 Button hello,0
  53.         EndMember FixMinHeight,,Weight,100
  54.  
  55.         hello: dc.b 'Hello',0
  56.  
  57.    Please note the double comma between FixMinHeight and Weight. The EndMember
  58.    macro is interpreted like this:
  59.  
  60.         EndMember [macro1,argmacro1,macro2,argmacro2,...]
  61.  
  62.    So  if  the  layout  macro specified does not require an argument you still
  63.    need to pass an empty argument. Upto seven macro/arg pairs can be passed.
  64.  
  65.  o The HGroupObject and VGroupObject automatically  pass a GROUP_Inverted tag.
  66.    The  PageObject  macro  automatically  passes a  PAGE_Inverted tag.  Do not
  67.    change this or your GUI will be created with the first object at the end of
  68.    the window. If you create custom group or page macros please make sure that
  69.    you add these tags.
  70.  
  71.  o The following macros are to be found in the assembly macros which  you will
  72.    not find in the C and E macros:
  73.  
  74.         DOMETHOD object,methodID[,arg1,args2,...]
  75.  
  76.         This  macro  will  invoke  method  'methodID' on object 'object'. Upto
  77.         eight  extra  arguments  can  be passed  to this macro. This should be
  78.         enough for most methods.
  79.  
  80.         DOGADGETMETHOD object,win,req,methodID[,arg1,arg2,...]
  81.  
  82.         The same as the DOMETHOD macro only this will call BGUI_DoGadgetMethod
  83.         and add a GadgetInfo structure to the method  so  that the  object can
  84.         do visual updates. This macro can take upto six extra arguments.
  85.  
  86.         PUTC value1[,value2,...]
  87.  
  88.         This macro pushes upto 15 immediate  or  absolute values on the stack.
  89.         The value you pass will get a  '#'  prepended  to it so only immediate
  90.         and absolute values are allowed.  All object creation  macros use this
  91.         macro.
  92.  
  93.         PUTV value1[,value2,...]
  94.  
  95.         The same as PUTC only the values will  not  get a '#' prepended so you
  96.         can add all sorts of data to the stack.
  97.  
  98.  For the rest the assembly macros should be  pretty  straight forward.  Please
  99. look at the supplied demo program "Demo.s"
  100.  
  101. Enjoy,
  102.                                     Jan
  103.